Skip to content

fix: quote skill descriptions to fix broken YAML frontmatter (specode 6.1.6 / task-swarm 0.10.5)#86

Merged
qxbyte merged 1 commit into
mainfrom
fix/skill-frontmatter-yaml
Jul 8, 2026
Merged

fix: quote skill descriptions to fix broken YAML frontmatter (specode 6.1.6 / task-swarm 0.10.5)#86
qxbyte merged 1 commit into
mainfrom
fix/skill-frontmatter-yaml

Conversation

@qxbyte

@qxbyte qxbyte commented Jul 8, 2026

Copy link
Copy Markdown
Owner

P0. PR #82's unified skill descriptions contain an unquoted Trigger: (half-width colon+space). In an unquoted YAML scalar, : is the mapping separator → frontmatter fails to parse; claude plugin validate errors and at runtime the whole frontmatter is silently dropped (name/description lost → skill discovery/activation affected).

  • Not a full-width-character issue — obsidian-wiki's descriptions are full of full-width punctuation (, , ——) and validate fine.
  • Affected: specode/skills/specode + task-swarm/skills/task-swarm (ragkit's 4 were fixed in 0.1.3).
  • Fix: double-quote both descriptions + escape internal quotes. Zero behavior change.

All 4 plugins now validate clean.

🤖 Generated with Claude Code

…frontmatter (P0)

PR #82 unified skill descriptions with an unquoted `Trigger: ` (HALF-WIDTH
colon+space). In an unquoted YAML scalar, `: ` is the key:value separator, so the
frontmatter failed to parse — `claude plugin validate` errored and at runtime the
whole frontmatter was silently dropped (name/description lost → skill discovery
affected). NOT caused by full-width punctuation (obsidian-wiki's descriptions are
full of full-width chars and validate fine). Fix: double-quote the two affected
descriptions and escape internal quotes. Zero behavior change. All 4 plugins now
validate clean. specode 6.1.6 / task-swarm 0.10.5 (ragkit fixed in 0.1.3).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: qxbyte <126648675+qxbyte@users.noreply.github.com>
@qxbyte qxbyte merged commit e0725d2 into main Jul 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant